Midterm ADB - Juan Manuel Rodríguez Barragán - 201317864¶
The main objective for this section of the midterm is to deliver a tool that can both test an Android app through ADB and also generate a report with detailed explanations of the test results. We expect your test suite to do the following:¶
- Install an android apk through ADB on either an emulator or an actual device.
- Launch the installed app.
- You are required to perform the events described below sequentially, until you have performed a total of N actions (have N be a parameter on your script)
- You are required to press the back button (through ADB) every X number of events, whilst maintaining the same order of events (insert, not replace), where X is your student code module 4 plus the last digit of your student code (std%4 + last digit). e.g. for student code 201618493, you would have to press back after every 4th event.
- Uninstall the app.
Your tool is also required to generate a report with the following properties:¶
- All events performed are listed in sequence on a document (PDF or HTML), each one with a header or description to identify which action was performed.
- A screenshot of each listed event is shown under it in the document. The screenshot must have been taken during run time at the exact moment of the execution of said event.
The sequence of events that we expect you to use is described in section 1 and 2 of this assignment.¶
For this section we expect you to deliver the source code (on the programming language of your choice) that performs the tests and generates the report as well as the APK that you are working with.¶
Solution:¶
- For this midterm I will use an Emulator called Nox, that's because I do not have any android device at home.
Calculate the number of events until next "back" command:¶
In [61]:
#Define the student id and also N (number of actions the script should perform)
student_code = 201317864
N = 8
steps = student_code % 4 + 4
print("The number of events until next back command for this student is: " + str(steps) )
print("The number of times the cicle will repeat is: " + str(N))
PREPARATION METHODS:¶
In [62]:
##connection to the device via ADB
import os
import time
from IPython.display import Image
from IPython.display import display
import PIL.Image
import subprocess
from ppadb.client import Client as AdbClient
#Path for the APK
apk_path = "/Users/juan/downloads/com.twitter.android.apk"
#Project path
project_path = "/Users/juan/downloads/"
#APK name
apk_name = "com.twitter.android"
# path for the adb which come with NOX emulator.
path = "/Users/juan/Library/Android/sdk/emulator"
comm = "./emulator -avd Nexus_5X_API_29_x86 -netdelay none -netspeed full"
# array of images and commands
img = []
command = []
#var for screenshot number
var = 1
# Change the directory to it.
os.chdir(path)
os.system(comm)
# Default is "127.0.0.1" and 5037
client = AdbClient(host="127.0.0.1", port=5037)
devices = client.devices()
In [63]:
#Method for storage commands into array
def commands(element):
command.append(element)
In [64]:
##Method for installing an android APK
#install twitter app
def install_app(apk_path):
for device in devices:
device.install(apk_path)
commands("Command used: adb install " + apk_path)
print("Command used: adb install " + apk_path)
In [65]:
##Method for launching an android APK
#launch twitter app
def launch_app(apk_name):
device.shell("monkey -p "+ apk_name + " -c android.intent.category.LAUNCHER 1")
commands("Command used: adb shell monkey -p "+ apk_name + " -c android.intent.category.LAUNCHER 1")
print("Command used: adb shell monkey -p "+ apk_name + " -c android.intent.category.LAUNCHER 1")
In [66]:
from ppadb.client import Client as AdbClient
In [67]:
#Method for uninstalling the app
def uninstall_app(apk_name):
for device in devices:
device.uninstall(apk_name)
commands("Command used: adb uninstall " + apk_name)
print("Command used: adb uninstall " + apk_name)
In [68]:
#Method for taking an screenshot
def screenshot():
for device in devices:
device.shell("screencap -p /sdcard/screencap.png")
commands("Command used: adb shell screencap -p /sdcard/screencap.png")
print("Command used: adb shell screencap -p /sdcard/screencap.png")
In [69]:
#Method for storage paths into array
def paths(element):
img.append(element)
In [74]:
#Method for retrieving an screenshot
def retrieve_image(project_path,var):
print("Command used: adb pull /sdcard/screencap.png " + project_path + "/screencap_" + str(var) + ".png")
for device in devices:
device.pull("/sdcard/screencap.png", project_path + "/screencap_" + str(var) + ".png")
element = project_path + "/screencap_" + str(var) + ".png"
paths(element)
commands("adb pull /sdcard/screencap.png " + project_path + "/screencap_" + str(var) + ".png")
#fp = open(project_path + "/screencap_" + str(var) + ".png","rb")
#img = PIL.Image.open(fp)
#img.show()
In [71]:
#method for display images
def image_display():
for image in img:
i = Image(filename= image)
display(i)
In [72]:
## Method for press back button every x number of events
def back_checker(i):
if(i%4 == 0):
os.system("adb shell input keyevent 4")
commands("Command used: adb shell input keyevent 4")
QUESTION 1¶
Go to the home menu and click on the first app avialable on the launcher, all via ADB.¶
- Using ADB, exit the current app.
- Using ADB, pull the display resolution and write it in the report.
- Using ADB, turn on bluetooth.
- Using ADB, launch the contacts app and add a new contact to the contact's list.
In [75]:
##Method for running the events sequentially
i = 0
while i <= N:
install_app(apk_path)
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
launch_app(apk_name)
i= i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
#Question Events -> exit current app
for device in devices:
device.shell("input keyevent 3")
commands("Command used: adb shell input keyevent 3")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
# adb shell service call bluetooth_manager 6 to turn on, 8 turn off
for device in devices:
device.shell("service call bluetooth_manager 6")
commands("adb shell service call bluetooth_manager 6")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
# adb create new contact:
#adb shell am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name 'Camila Fernandez' -e phone 123456789
#adb shell input keyevent 4
#adb shell input keyevent 4
for device in devices:
device.shell("am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name 'Camila" + str(i) + " Fernandez' -e phone 1234567")
commands("adb shell am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name 'Camila" + str(i) + " Fernandez' -e phone 1234567")
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
for device in devices:
device.shell("input keyevent 4")
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
for device in devices:
device.shell("input keyevent 4")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
uninstall_app(apk_name)
print(img)
print(command)
QUESTION 2¶
Go to the home menu and click on the first app avialable on the launcher, all via ADB.¶
- Go to the home menu and click on the first app avialable on the launcher, all via ADB.
- Go to the home menu and long tap the first 3 apps available on the launcher, all via ADB.
- Using ADB, verify the current battery percentage and write it in the report.
- Using ADB, turn on bluetooth.
- Using ADB, launch the contacts app and add a new contact to the contact's list.
In [77]:
##Method for running the events sequentially
i = 0
while i <= N:
install_app(apk_path)
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
launch_app(apk_name)
i= i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
#Question Events -> exit current app
for device in devices:
device.shell("input keyevent 3")
commands("Command used: adb shell input keyevent 3")
for device in devices:
device.shell("input tap 76 464")
commands("adb shell input tap 76 464")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
for device in devices:
device.shell("input keyevent 3")
commands("Command used: adb shell input keyevent 3")
for device in devices:
device.shell("input tap 76 464 76 464 250")
commands("Command used: adb shell input tap 76 464 76 464 250")
device.shell("input tap 214 474 214 474 250")
commands("Command used: adb shell input 214 474 214 474 250")
device.shell("input tap 366 466 366 466 250")
commands("adb shell input tap 366 466 366 466 250")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
# adb shell service call bluetooth_manager 6 to turn on, 8 turn off
for device in devices:
device.shell("service call bluetooth_manager 6")
commands("adb shell service call bluetooth_manager 6")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
# adb create new contact:
#adb shell am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name 'Camila Fernandez' -e phone 123456789
#adb shell input keyevent 4
#adb shell input keyevent 4
for device in devices:
device.shell("am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name 'Camila" + str(i) + " Fernandez' -e phone 1234567")
commands("adb shell am start -a android.intent.action.INSERT -t vnd.android.cursor.dir/contact -e name 'Camila" + str(i) + " Fernandez' -e phone 1234567")
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
for device in devices:
device.shell("input keyevent 4")
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
for device in devices:
device.shell("input keyevent 4")
i = i + 1
time.sleep(5)
screenshot()
retrieve_image(project_path,var)
var = var + 1
back_checker(i)
if i == N:
break
uninstall_app(apk_name)
print(img)
print(command)
In [78]:
print("List of commands and screenshot for both of the Questionaries")
print("-------------------------------------------------------------")
print("-----------------COMMANDS-----------")
for x in command:
print(x)
print("-----------------IMAGES-----------")
for image in img:
vx = 1
i = Image(filename= image)
print("IMAGE # ", vx)
display(i)
vx = vx + 1
In [ ]:
from fpdf import FPDF
pdf = FPDF()
pdf.add_page()
pdf.set_font("Arial", size=12)
pdf.cell(200, 10, txt="ADB - MIDTERM NOTEBOOK", ln=1, align="C")
for x in command:
pdf.cell(200, 10, txt=x, ln=1, align="L")
for image in img:
pdf.image(image)
pdf.output("/Users/juan/downloads/ADB.pdf")
In [ ]: